hal_nfc_config.h

Go to the documentation of this file.

#ifndef HAL_NFC_CONFIG_H
#define HAL_NFC_CONFIG_H
 
/* ******************* HAL terminal nfc configuration API declaration ********************** */
/* ***************************************************************************************** */
 
/* set struct alignment */
#include <emv_platform_set_align.h>
 
/* ***************************************************************************************** */
/* ***************************************************************************************** */
 
 
/* *********************** Mask used in hal_cfg_get_nfc_ep_config ************************** */
#define KER_CFG_EP_MASK_STATUS_CHECK                    0x0001      
#define KER_CFG_EP_MASK_ZERO_AMOUNT                     0x0002      
#define KER_CFG_EP_MASK_ZERO_AMOUNT_OFFLINE     0x0004      
#define KER_CFG_EP_MASK_RDR_CLESS_LIMIT             0x0008      
#define KER_CFG_EP_MASK_RDR_CLESS_FLOOR_LIMIT   0x0010      
#define KER_CFG_EP_MASK_RDR_CVM_REQ_LIMIT           0x0020      
#define KER_CFG_EP_MASK_TTQ                                     0x0040      
#define KER_CFG_EP_MASK_EXT_SEL_SUPPORT             0x0080      
#define KER_CFG_EP_PRE_STATUS_CHECK_REQUESTED                               0x0001  
#define KER_CFG_EP_PRE_CLESS_APP_NOT_ALLOWED                                0x0002  
#define KER_CFG_EP_PRE_ZERO_AMOUNT                                                  0x0004  
#define KER_CFG_EP_PRE_RDR_CVM_REQ_LIMIT_EXCEEDED                       0x0008  
#define KER_CFG_EP_PRE_RDR_CLESS_FLOOR_LIMIT_EXCEEDED               0x0010  
typedef struct tag_HAL_CONFIG_NFC_COMB HAL_CONFIG_NFC_COMB;
 
typedef struct tag_HAL_CONFIG_NFC_COMB
{
    KER_INT16U  usSize;                                     
    KER_BYTE btVer;                                             
    KER_BYTE ar_btAID[16];                              
    KER_BYTE btAIDLen;                                      
    KER_BYTE ar_btKernelID[8];                      
    KER_BYTE btKernelIDLen;                             
    KER_INT16U usConfDataPresentMask;           
    KER_INT16U usConfDataSetMask;                   
    KER_INT16U usPreprocIndicators;             
    KER_BYTE ar_btTTQ[4];                                   
    KER_BYTE ar_btLimitClessTran[4];            
    KER_BYTE ar_btLimitClessFloor[4];           
    KER_BYTE ar_btLimitCVMRequired[4];      
    KER_TLV* pConfigData;                                   
    KER_TLV* pTranData;                                     
    HAL_CONFIG_NFC_COMB* pNext;                     
}HAL_CONFIG_NFC_COMB;
 
/* ****************************** hal_cfg_get_nfc_ep_config ******************************** */
extern KER_BOOL hal_cfg_get_nfc_ep_config(KER_CTX_PARAM KER_TLV* pTranData, HAL_CONFIG_NFC_COMB** ppCombList);
 
/* ************************** hal_cfg_get_nfc_default_kernel_id **************************** */
extern KER_BOOL hal_cfg_get_nfc_default_kernel_id(KER_CTX_PARAM const KER_BYTE* pAID, KER_INT16U usAIDLen, KER_BYTE* pbtKernelID, KER_BYTE* pbtKernelIDLen, KER_BYTE btMaxLen);
 
/* *************************** hal_cfg_get_nfc_custom_kernel_id **************************** */
extern KER_BOOL hal_cfg_get_nfc_custom_kernel_id(KER_CTX_PARAM const KER_BYTE* p61, KER_INT16U us61Len, KER_BYTE* pbtKernelID, KER_BYTE* pbtKernelIDLen, KER_BYTE btMaxLen);
 
/* ********** ID used in hal_cfg_get_config_by_id and hal_cfg_set_config_by_id ************* */
 
/* ******************************* ENTRY POINT CONFIGURATION ******************************* */
#define KER_CFG_ID_NFC_EP_STATUS_CHECK                          0x1001
 
#define KER_CFG_ID_NFC_EP_ZERO_AMOUNT                               0x1002
 
#define KER_CFG_ID_NFC_EP_ZERO_AMOUNT_OFFLINE               0x1003
 
#define KER_CFG_ID_NFC_EP_EXT_SEL_SUPPORT                       0x1004
 
#define KER_CFG_ID_NFC_EP_TTQ                                               0x1005
 
#define KER_CFG_ID_NFC_EP_CLESS_TRAN_LIMIT                  0x1006
 
#define KER_CFG_ID_NFC_EP_CLESS_FLOOR_LIMIT                 0x1007
 
#define KER_CFG_ID_NFC_EP_CVM_REQUIRED_LIMIT                0x1008
 
#define KER_CFG_ID_NFC_PREPROC_INDICATORS_MASK          0x1009
 
 
#define KER_CFG_ID_NFC_EP_COLLISION_RESOLUTION_TIMEOUT  0x1021
 
#define KER_CFG_ID_NFC_EP_SPI                                               0x1031
 
#define KER_CFG_ID_NFC_EP_CPCL_DATA_REQUEST                 0x1032
#define KER_CFG_NFC_EP_CPCL_DATA_REQUEST_ENABLED                    0x01        
#define KER_CFG_NFC_EP_CPCL_DATA_REQUEST_FAILURE_FATAL      0x02        
#define KER_CFG_ID_NFC_EP_KEEP_TRAN_AFTER_SELECT_NEXT   0x1033
 
#define KER_CFG_ID_NFC_EP_CPCL_DATA                                     0x1034
 
 
/* ***************************** COMMON NFC KERNEL PARAMETERS ****************************** */
#define KER_CFG_ID_NFC_EMV_DATA_RECORD_TAG_LIST         0x1101
 
#define KER_CFG_ID_NFC_EMV_DISCR_DATA_TAG_LIST          0x1102
 
#define KER_CFG_ID_NFC_MS_DATA_RECORD_TAG_LIST          0x1103
 
#define KER_CFG_ID_NFC_MS_DISCR_DATA_TAG_LIST               0x1104
 
#define KER_CFG_ID_NFC_DATA_RECORD                                  0x1105
 
#define KER_CFG_ID_NFC_DISCR_DATA                                       0x1106
 
#define KER_CFG_ID_NFC_ENABLE_BIN_RANGE_ID_TRACE        0x1107
 
#define KER_CFG_ID_NFC_BIN_RANGE_ID                                 0x1108
 
#define KER_CFG_ID_NFC_ENABLE_DEDS                                  0x1111
 
#define KER_CFG_ID_NFC_DATA_EXCHANGE_LIST                       0x1112
 
#define KER_CFG_ID_NFC_FIELD_OFF_TIMEOUT                        0x1121
 
#define KER_CFG_ID_NFC_APDU_TIMING_LATENCY                  0x1122
 
#define KER_CFG_ID_NFC_TRAN_CONTEXT_TAG_LIST                0x1131
 
#define KER_CFG_ID_NFC_GPO_APDU_TIMEOUT                         0x1141
 
#define KER_CFG_ID_NFC_GAC_APDU_TIMEOUT                         0x1142
 
#define KER_CFG_ID_NFC_PT_APDU_TIMEOUT                          0x1143
 
#define KER_CFG_ID_NFC_PT_LIGHT_APDU_TIMEOUT                0x1144
 
#define KER_CFG_ID_NFC_CT_APDU_TIMEOUT                          0x1145
 
#define KER_CFG_ID_NFC_CCC_APDU_TIMEOUT                         0x1146
 
#define KER_CFG_ID_NFC_ERRD_APDU_TIMEOUT                        0x1147
 
 
/* ****************************** MASTERCARD KERNEL PARAMETERS ***************************** */
/* 
 *  C-2 Option name: "Mag-stripe mode contactless transactions not supported" - DF811B Byte 1 bit 8
 *  C-2 Option name: "EMV mode contactless transactions not supported" - DF811B Byte 1 bit 7
 *  C-2 Option name: "On device cardholder verification supported" - DF811B Byte 1 bit 6
 *  C-2 Option name: "Relay resistance protocol supported" - DF811B Byte 1 bit 5
 *  C-2 Option name: "Read all records even when no CDA" - DF811B Byte 1 bit 3
 */
 
#define KER_CFG_ID_NFC_MC_FAILED_MS_CNTR                        0x1201
 
 
/* ******************************** VISA KERNEL PARAMETERS ********************************* */
#define KER_CFG_ID_NFC_VISA_DISABLE_AUC_FOR_MANUAL_CASH     0x1301
 
#define KER_CFG_ID_NFC_VISA_DISABLE_AUC_FOR_CASHBACK        0x1302
 
#define KER_CFG_ID_NFC_VISA_FORCE_ONLINE_IF_APP_EXPIRED 0x1303
 
 
/* ******************************** AMEX KERNEL PARAMETERS ********************************* */
#define KER_CFG_ID_NFC_AMEX_MPOS                                        0x1401
 
 
/* ********************************* MIR KERNEL PARAMETERS ********************************* */
#define KER_CFG_ID_NFC_MIR_OUTCOME_UI_STATUS                0x1F01
 
#define KER_CFG_ID_NFC_MIR_OUTCOME_CVM_STATUS               0x1F02
 
#define KER_CFG_ID_NFC_MIR_CPLC_MAND_FOR_PROT_01        0x1F03
 
#define KER_CFG_ID_NFC_MIR_CPLC_MAND_FOR_PROT_02        0x1F04
 
 
/* restore struct alignment */
#include <emv_platform_restore_align.h>
 
#endif /* HAL_NFC_CONFIG_H */